home *** CD-ROM | disk | FTP | other *** search
/ Informática Multimedia 1995 April / Informatica Multimedia CD - Epimundo.iso / DOS / FILEFIND / DCWHERE.ZIP / DCWHERE.DOC < prev    next >
Encoding:
Text File  |  1987-02-19  |  11.8 KB  |  242 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                        DCWHERE
  8.  
  9.           DCWHERE displays information about all occurances of  a  filename
  10.           regardless of which directory the filename is located.   Its main
  11.           use is to find that file that you are sure you created but is not
  12.           where it is supposed to be.   The proper syntax for using DCWHERE
  13.           is  DCWHERE  filename.    Filename  is  any  valid  DOS  filename
  14.           including the ? and * wildcards. A filename is composed of 1 to 8
  15.           characters  which  can  be  followed  by  a  period  and  a three
  16.           character extension.  If you have a color display the information
  17.           will be displayed as yellow  characters  on  a  blue  background.
  18.           This  color  combination cannot be changed.   The filename can be
  19.           entered in upper or  lower  case  letters.    All  filenames  are
  20.           compared  as  upper case.  The ?  character is special in that it
  21.           will match any one character in a filename.  The  following  list
  22.           illustrates how the ? wild card works.
  23.                TEST?.DAT         TEST4.dat         match
  24.                TEST?.dat         TEST.dat          match
  25.                TEST?.EXE         TEST12.EXE        do not match
  26.                TEST.?AT          TEST.BAT          match
  27.                TEST.?AT          TEST.DAT          match
  28.           The  *  character  is also a wildcard character.   It matches all
  29.           remaining characters in a filename or extension.   The  following
  30.           list illustrates the use of the * wildcard
  31.                *.*               TEST.EXE          match
  32.                *.*               FROG.DAT          match
  33.                *.dat             MAIN.DAT          match
  34.                *.DAT             MAIN.BAT          do not match
  35.                TEST*             TEST23            match
  36.                TEST.*            TEST.BAT          match
  37.                TEST.*            TEST.EXE          match
  38.           DCWHERE  *.* matches all files.   DCWHERE *.bat matches all files
  39.           with an extension of BAT.  DCWHERE TEST.* matches all files whose
  40.           filename  is  TEST  regardless  of  the   extension.      DCWHERE
  41.           TEST????.dat will list all files whose extension is DAT and whose
  42.           first  four  characters  are  TEST.   The remaining four possible
  43.           characters can either be absent or any character and still match.
  44.  
  45.                The screen is laid out in four columns as is shown below
  46.  
  47.                  LOCATION         DATE LAST MODIFIED  SIZE    ATTRIBUTE
  48.                C:\IBMBIOS.COM           8/22/85      341256       RSHA
  49.                C:\IBMDOS.COM            8/22/85      221945       RSHA
  50.                C:\TEST.COM              7/12/86         451       A
  51.                C:\DBASE\DBASE.COM       4/22/85       12334       A
  52.  
  53.           Column one is the location and name of the file that matches  the
  54.           filename       specified.               Its       format       is
  55.           DRIVE:\DIRECTORY1\DIRECTORY2\FILENAME.   Column two is  the  date
  56.           the file was last modified.  Column three is the size in bytes of
  57.           the  file.   The date and size information is the same as the DIR
  58.           command will give.   Column four is the attribute  bytes  of  the
  59.  
  60.                                           1
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.           file.    H  means  that the file is HIDDEN.   It will not show up
  68.           using a DIR command.   S means SYSTEM.   Files  with  the  SYSTEM
  69.           attribute set will not show up with a DIR command.   R means READ
  70.           ONLY.   This file cannot be modified or deleted.   The  ATTRIBUTE
  71.           command  can be used to change this attribute.   A means ARCHIVE.
  72.           This means that the file has been modified since the last  BACKUP
  73.           command  was used.   It has no real signifigance outside of being
  74.           used in the BACKUP command.   A file can and often does have more
  75.           that  one  attribute  set.    Line  23  of  the  screen shows the
  76.           directories as they are  being  searched.    Line  24  will  show
  77.           continuation and error messages.  If there are 19 or more matches
  78.           the program will pause and ask if you want to continue searching.
  79.           Pressing any key but N or n will continue searching.
  80.  
  81.                ERROR MESSAGES
  82.  
  83.           Backslash  in  file  name  ----  The  program  will  check in all
  84.           directories.  Since the backslash marks a directory it should not
  85.           be  included  in  a  filename.   Reenter the filename without the
  86.           directory information and backslash.  DCWHERE \DOS\*.COM  (wrong)
  87.           DCWHERE *.COM  (correct)
  88.  
  89.           Drive identifier in file name ---- The program will always search
  90.           the current drive only.  Therefor the drive identifier should not
  91.           be entered. DCWHERE c:*.bat   (wrong)    DCWHERE *.bat  (correct)
  92.  
  93.           File name too long ---- DOS limits file names to eight characters
  94.           optionaly followed by a period and a three  character  extension.
  95.           Reenter  a  valid  file name.   DCWHERE test1234b (wrong) DCWHERE
  96.           test1234.b (correct)
  97.  
  98.           File extension too long ---- DOS limits the number of  characters
  99.           following  the  period  in a file name to three.   Reenter with a
  100.           valid extension.  DCWHERE *.test (wrong) DCWHERE *.tst (correct)
  101.  
  102.           Only two '*' characters allowed ---- DOS  handles  only  one  '*'
  103.           wildcard  before  the  period and one after the period.   Reenter
  104.           using only one '*' on either side of the period.  DCWHERE  *sd*.*
  105.           (wrong) DCWHERE ?sd*.* (correct).
  106.  
  107.           Only one '*' character allowed after period ---- DOS handles only
  108.           one  '*' wildcard character after the period.   The second one is
  109.           ignored.     Reenter  using  only  one  '*'  after  the   period.
  110.           DCWHERE dbase.**  (wrong)   DCWHERE dbase.*  (correct)
  111.  
  112.           Both  '*'  characters  appear before the period ---- There can be
  113.           only one '*' wildcard character before the period.   Reenter with
  114.           only  one  '*'  before  the  period.    DCWHERE *123*.wks (wrong)
  115.           DCWHERE ?123*.wks (correct)
  116.  
  117.           Return code not found ---- Internal programming problem.   Please
  118.           send  the  example to me at the address in the first part of this
  119.  
  120.                                           2
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.           documentation.
  128.  
  129.           No files found on disk ---- This is a newly formated disk with no
  130.           files on it to search through.   Use the command on a  disk  with
  131.           files already in place.
  132.  
  133.           Only  60  directories  can be searched ----  There is an internal
  134.           limit of 60 directories that can be searched by this program.
  135.  
  136.           No file specified to look for ----    You  did  not  include  the
  137.           filename  to  be  searched  for.    Reenter  with  a  file  name.
  138.           DCWHERE  (wrong)  DCWHERE *.bat (correct)
  139.  
  140.           No files are present that match  (filename)  ----    The  program
  141.           could  not find any files that match the filename specified.   It
  142.           is not on the hard disk.
  143.  
  144.           All directories searched ---- The program  has  filished  looking
  145.           through all the directories on the hard disk.
  146.  
  147.                GLOSSARY
  148.  
  149.           Attribute  -- Dos has four indicators that it saves for each file
  150.           called Attributes.  They tell wheather the file is a System file,
  151.           Hidden file,  or Read Only file.    The  fourth  indicator  tells
  152.           wheather the file has been changed since it was last backed up.
  153.  
  154.           Backup  --    The  DOS  command  used to copy files to the floppy
  155.           diskettes for backup  purposes.    This  program  turns  off  the
  156.           Archive  indicator  for  the  files  copied.   Files copied using
  157.           Backup can only be restored using the Restore command.
  158.  
  159.           Directory -- A  collection  of  related  files  that  usualy  are
  160.           involved with one type of work.  A directory can be thought of as
  161.           a file drawer in a filing cabinet.  The cabinet is the hard disk.
  162.           Each  area  has  its  own drawer to keep its information seperate
  163.           from the other areas.   This makes it easier to  search  through.
  164.           Using the Tree command will display the directory structure.
  165.  
  166.           DOS  --  Disk  Operating  System.   This is a program that is the
  167.           gateway into the computer.   It loads and executes porgrams  plus
  168.           gives you a collection of utilities to manage your computer.  You
  169.           can tell its there when you see the C:> prompt.
  170.  
  171.           Extension  --  A  filename  can have one to eight characters as a
  172.           filename and optionaly have a period and one to three  characters
  173.           as an extension.   Generaly extensions tell what type of file you
  174.           are dealing with.
  175.  
  176.           Filename -- A filename can have one to eight characters as a name
  177.           and optionaly have a period and one to  three  characters  as  an
  178.           extension.  They are how we distinguish files from each other.
  179.  
  180.                                           3
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.           Hidden  --  The  attribute  that  controls  wheather  a file will
  189.           display when the Dir is used.    Also  a  file  with  the  hidden
  190.           attribute set cannot be deleted or copied using Dos commands.
  191.  
  192.           Read  Only  --  The attribute that controls the access to a file.
  193.           If a file is Read Only it cannot be deleted or copied  using  Dos
  194.           commands.  It can be viewed and executed.
  195.  
  196.           System  --  The  attribute  that specifies files that are part of
  197.           DOS.  Has also been used in some copy protection schemes.  System
  198.           files cannot be deleted or copied using Dos commands  other  than
  199.           Sys  to  transfer  the system to a disk(ette) and Formatting with
  200.           the \s option to transfer the system.
  201.  
  202.           Wildcard -- Either the '?' or '*' character in a filename.    The
  203.           '?'  wildcard  will  match  any one character in a filename to be
  204.           matched with.  It will also match the absence of a character in a
  205.           filename.  The '*' wildcard matched all remaining characters in a
  206.           filename or extension in the same manner that the '?'  matches  a
  207.           single  character.   Both types of wildcards can be used together
  208.           in the same filename.
  209.  
  210.  
  211.  
  212.  
  213.          ----------------end-of-author's-documentation---------------
  214.  
  215.                         Software Library Information:
  216.  
  217.                    This disk copy provided as a service of
  218.  
  219.                         The Public (Software) Library
  220.  
  221.                   Disks in the library are updated monthly.
  222.          For a copy of the latest monthly software library newsletter
  223.           and a list of the 800+ disks in the library, call or write
  224.  
  225.                         The Public (Software) Library
  226.                                P.O.Box 35705 D
  227.                            Houston, TX 77235-5705
  228.                                (713) 721-6104
  229.  
  230.          We are not the authors of this program, nor are we associated
  231.          with the author in any way other than as a distributor of the
  232.          program in accordance with the author's terms of distribution.
  233.  
  234.          Please direct shareware payments and specific questions about
  235.          this program to the author of the program, whose name appears
  236.          elsewhere in  this documentation. If you have trouble getting
  237.          in touch with the author,  we will do whatever we can to help
  238.          you with your questions. All programs have been tested and do
  239.          run.  To report problems,  please use the form that is in the
  240.          file PROBLEM.DOC on many of our disks.
  241.  
  242.